home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / fsm340.zip / FSUMM.DOC < prev    next >
Text File  |  1991-03-30  |  20KB  |  336 lines
  1.     S/e/m/a/j Communications FileSummary                              Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                     ┌─▄█▀▀█▄────────────────────────────██─┐
  16.                     │ ██  ██ ▄█▀▀█▄ ██▀██▀█▄ ▄█▀▀█▄     ██ │
  17.                     │ ██     ██  ██ ██ ██ ██ ▀▀  ██     ██ │
  18.                     │  ▀▀▀█▄ ██▀▀▀▀ ██ ██ ██ ▄█▀▀██     ██ │
  19.                     │     ██ ██  ██ ██ ██ ██ ██  ██ █▄  ██ │
  20.                     │ ██  ██ ▀█▄▄█▀ ██ ██ ██ ▀█▄▄██ ██  ██ │
  21.                     └─▀█▄▄█▀────────────────────────▀█▄▄█▀─┘
  22.                             S/e/m/a/j Communications
  23.  
  24.  
  25.                                   * Presents *
  26.  
  27.  
  28.        ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  29.   ┌────█    ▐▌ █ ▐███▌    █ ▐  ▐▌ █▌ █ ▐  ▌ ▐▌ ▌ ▐  █ ▐  ▐▌ ▌  █ ▐█ ▐▌ █────┐
  30.   │    █ ▐███▌ █ ▐███▌ ████ ▐███▌ █▌ █ ▐▌ █ ▐▌ █ ▐▌ █ ▐█ ▐▌ █▌ █ ▐█ ▐▌ █    │
  31.   │    █ ▐  ▐▌ █ ▐███▌ ▌  █    ▐▌ █▌ █ ▐▌ █ ▐▌ █ ▐▌ █  ▐ ▐▌ ▌  █  ▐ ▐▌ █    │
  32.   │    █ ▐███▌ █ ▐███▌ ███████ ▐▌ █▌ █ ▐███ ▐▌ ███▌ █ ▐█ ▐▌ █ ▐████ ▐███    │
  33.   └────█ ▐███▌ █ ▐  ▐▌ ▌  █  ▐ ▐▌ ▌  █ ▐███ ▐▌ ███▌ █ ▐█ ▐▌ █▌ █    ▐▌ █────┘
  34.        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  35.  
  36.  ·──── A Fast FILES.BBS Summary and AllFiles Lister for RemoteAccess BBS! ────·
  37.  
  38.      Program Revision 3.40 is a MAJOR update... Please read these docs, and
  39.      the sample configuration file well. Upgrading may need a little work -
  40.      but it's worth it for the extra speed and *many* advanced features!!!!
  41.  
  42.                 ** FileSummary now works with NOVELL NETWARE! **
  43.  
  44.           NB! The control file has been renamed and is very different!
  45.  
  46.           Some commands are gone, and there are many new ones. There's
  47.           fundamental changes with the Megalist-creating verbs, so you
  48.           may need to take a look at that (we now create any number of
  49.           lists, containing specific areas in each).
  50.     S/e/m/a/j Communications FileSummary                              Page 2
  51.  
  52.     STANDARD DISCLAIMER (I'm sure you've seen it before somewhere)
  53.     ~~~~~~~~~~~~~~~~~~~
  54.     This product is meant for educational purposes only.  Any resemblance to
  55.     real  persons,   living  or  dead is purely  coincidental.   Void  where
  56.     prohibited.  Some assembly required.  List each check separately by bank
  57.     number. Batteries not included. Contents may settle during shipment. Use
  58.     only  as directed.  No other warranty expressed or implied.  Do not  use
  59.     while operating a motor vehicle or heavy equipment. Postage will be paid
  60.     by  addressee.  Subject to CAB approval.  This is not an offer  to  sell
  61.     securities.   Apply only to affected area.  May be too intense for  some
  62.     viewers.   Do not stamp.  Use other side for additional  listings.   For
  63.     recreational use only.  Do not disturb. All models over 18 years of age.
  64.     If condition persists, consult your physician. No user-serviceable parts
  65.     inside.   Freshest  if eaten before date on carton.   Subject  to change
  66.     without  notice.   Times  approximate.  Simulated picture.   No  postage
  67.     necessary  if  mailed in the United States.  Breaking  seal  constitutes
  68.     acceptance of agreement.  For off-road use only. As seen on TV. One size
  69.     fits all.  Many suitcases look alike.  Contains a substaintial amount of
  70.     non-tobacco ingredients.  Colors may,  in time,  fade.  We have sent the
  71.     forms which seem to be right for you. Slippery when wet.  For office use
  72.     only.  Not affiliated with the American Red Cross.  Drop in any mailbox.
  73.     Edited for television. Keep cool; process promptly. Post office will not
  74.     deliver without postage. List was current at time of printing. Return to
  75.     sender, no forwarding order on file, unable to forward.  Not responsible
  76.     for direct, indirect, incidental or consequential damages resulting from
  77.     any defect,  error  or  failure  to perform.  At participating locations
  78.     only. Not the Beatles. Penalty for private use. See  label for sequence.
  79.     Substantial penalty for early withdrawal.  Do not write below this line.
  80.     Falling rock.  Lost ticket pays maximum rate.  Your  cancelled  check is
  81.     your receipt.  Add toner.  Place stamp  here.  Avoid contact with  skin.
  82.     Sanitized for your protection.  Be sure  each item is properly endorsed.
  83.     Sign  here  without  admitting  guilt.   Slightly  higher  west  of  the
  84.     Mississippi.  Employees and their families are not eligible.   Beware of
  85.     owl.  Contestants have been briefed  on  some questions before the show.
  86.     Limited time offer,  call now  to  insure prompt  delivery.  You must be
  87.     present  to win.  No passes accepted  for this engagement.  No  purchase
  88.     necessary.   Processed  at location stamped in code at  top  of  carton.
  89.     Shading  within a garment may occur.  Use only in  well-ventilated area.
  90.     Keep  away  from fire or flame.  Replace  with same type.  Approved  for
  91.     veterans. Booths for two or more.  Check here if tax  deductible.   Some
  92.     equipment shown is optional.  Price does not include taxes.  No Canadian
  93.     coins.  Not recommended  for  children. Prerecorded  for this time zone.
  94.     Reproduction strictly prohibited.  No solicitors.  No alcohol, dogs,  or
  95.     horses. No anchovies unless otherwise specified. Restaurant package, not
  96.     for resale. List at least two alternate dates.  First pull up, then pull
  97.     down. Call toll free before digging. Driver does not carry cash. Some of
  98.     the  trademarks mentioned in  this  product  appear  for  identification
  99.     purposes only. Record additional transactions on back of previous stub.
  100.  
  101.                       This supersedes all previous notices.
  102.  
  103.     S/e/m/a/j Communications FileSummary                              Page 3
  104.  
  105.     Disclaimer:
  106.     ~~~~~~~~~~~
  107.     CREDITS!
  108.     ~~~~~~~~
  109.     Documentation:                                (c) stuart henderson & MTD
  110.                                                  ≈dataMatrix≈ +44 392 434477
  111.     Standard Disclaimer:             James found it hanging around somewhere
  112.     Program Code:                         (C) S/e/m/a/j Communications, 1990
  113.     Original Design:                     Martin Parry ■ Particle Programming
  114.     Author:                                                      James Berry
  115.                                           S/e/m/a/j ■ 0303 862415 ■ 2:440/16
  116.     Compiler:                   TopSpeed C, Jensen & Partners, International
  117.     RemoteAccess from:                                  Continental Software
  118.  
  119.     Introduction to S/e/m/a/j Communications
  120.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  121.     S/e/m/a/j  Communications  basically writes really neat little  programs
  122.     generally  intended to help sysops out.  If you have a great idea for  a
  123.     program  then  please send a message on to one of the beta  testers  who
  124.     will  forward  it  via the SEMAJ.BETA echo to the author.   If  you  are
  125.     interested  in  becoming a beta tester,  please send  James  Berry  (the
  126.     author)  a  netmail message to 2:440/16,   or better still,  ring up the
  127.     board and YELL for him. If you are accepted, you must be able to pick up
  128.     the SEMAJ.BETA echo from any existing beta-test site.
  129.  
  130.     Copyright
  131.     ~~~~~~~~~
  132.     Although  these programs are distributed freely,  it does not mean  they
  133.     are in the public domain.  You may use them for a trial period until you
  134.     have  decided  whether  or  not  to  register  them.   For  details   on
  135.     registration,    please  see  the  enclosed  SEMAJ.REG  file  for   more
  136.     information.  This program is part of the special discount  registration
  137.     scheme detailed in that file, as are most other S/e/m/a/j Communications
  138.     products (£20, which is approximately $40, for all current and future £5
  139.     registration  S/e/m/a/j  Communications  programs.  Even now  there  are
  140.     already  more  than  4  programs at the £5  fee so you  can  save  money
  141.     already!)
  142.  
  143.     CONTENTS!
  144.     ~~~~~~~~~
  145.     The  distribution  archive  is in "PkZip"  format.  It  should  only  be
  146.     distributed  in  that  format.  The files in the archive should  be  the
  147.     following, and ONLY the following. If there are any other files added to
  148.     the archive, you should inform S/e/m/a/j Communications. Adding files to
  149.     the archive constitutes altering the program.
  150.  
  151.     ■──────────────┬───────────────────────────────────────────────────────┐
  152.     │ FBBSHEAD.FSM │ Demonstration Header File for your FILES.BBS          │
  153.     │ FSUMM.CFG    │ FileSummary Control File [can be renamed, read on]    │
  154.     │ FSUMM.DOC    │ The Documentation - What you're reading now!          │
  155.     │ FSUMM.EXE    │ The Main Program                                      │
  156.     │ MEGAHEAD.FSM │ Demonstration Header File for the MegaList            │
  157.     │ SEMAJ.REG    │ Registration Form                                     │
  158.     │ SEMAJ.LST    │ List of Beta-Testers, reg'd users, support boards     │
  159.     │ WARRANTY.DOC │ Your Guarantee                                        │
  160.     └──────────────┴───────────────────────────────────────────────────────┘
  161.     S/e/m/a/j Communications FileSummary                              Page 4
  162.  
  163.     What FileSummary Does, And Why It Exists
  164.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  165.     You  will  probably  already  have seen what  FileSummary  does  to  the
  166.     FILES.BBS  while  looking  at a file list on a BBS that  uses  it.    By
  167.     default,  it inserts a little bit of information about the file area  at
  168.     the  beginning  of FILES.BBS,  including things like  the  area's  name,
  169.     number  of  files in the area,  and total space used by this area.    It
  170.     scans your FILES.RA file (in the RA system directory) for all file areas
  171.     and  edits  the  file  listing  in those  areas.    Note  that  although
  172.     FileSummary  remembers which directory you started from on  the  current
  173.     drive,   and leaves you there when it has finished,  it may have changed
  174.     the directory on  other drives mentioned  in FILES.RA.  FileSummary will
  175.     search for FILES.RA firstly  in the current directory,  and then in  the
  176.     directory pointed to by the environment variable "RA".
  177.  
  178.     Typical Non-FileSummarized, Sample FILES.BBS File
  179.     ────────────────────────────────────────────────────────────────────────
  180.     3-DEMoN.ZiP [0] 3D Pac-man type game.
  181.     ABM.ZIP  [00] Anti-Bolistic Missile game
  182.     aLleYCaT.ZIP [00] Get the rats in this arcade game
  183.     Antix.Zip  [4] Another game from the author of Tetris
  184.  
  185.     A Sample FILES.BBS File After FileSummarizing (slightly edited)
  186.     ────────────────────────────────────────────────────────────────────────
  187.                            -=-  FileSummary v3.40ß  -=-
  188.  
  189.   █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  190.   █         Files listing last updated on: Sun Jul 29 23:43:24 1990         █
  191.   █                                                                         █
  192.   █     File Directory:                                       IBM Games     █
  193.   █     Number of files found:  99               Total bytes:  43172338     █
  194.   █                                                                         █
  195.   █─────────┬───────┬────────┬──────────────────────────────────────────────█
  196.   █  File   │ Size  │  Date  │                File Description              █
  197.   ══════════╧═══════╧════════╧═══════════════════════════════════════════════
  198.   3-DEMON.ZIP  [00] 3D Pac-man type game.
  199.   ABM.ZIP      [00] Anti-Bolistic Missile game
  200.   ALLEYCAT.ZIP [00] Get the rats in this arcade game
  201.   ANTIX.ZIP    [04] Another game from the author of Tetris
  202.  
  203.     A Sample FILES.BBS Being Displayed in RemoteAccess (slightly edited)
  204.     ────────────────────────────────────────────────────────────────────────
  205.                            -=-  FileSummary v3.40ß  -=-
  206.  
  207.   █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  208.   █         Files listing last updated on: Sun Jul 29 23:43:24 1990         █
  209.   █                                                                         █
  210.   █     File Directory:                                       IBM Games     █
  211.   █     Number of files found:  99               Total bytes:  43172338     █
  212.   █                                                                         █
  213.   █─────────┬───────┬────────┬──────────────────────────────────────────────█
  214.   █  File   │ Size  │  Date  │                File Description              █
  215.   ══════════╧═══════╧════════╧═══════════════════════════════════════════════
  216.   3-DEMON.ZIP  21147 04-12-90  [00] 3D Pac-man type game.
  217.   ABM.ZIP      24217 04-12-90  [00] Anti-Bolistic Missile game
  218.   ALLEYCAT.ZIP 35522 04-12-90  [00] Get the rats in this arcade game
  219.   ANTIX.ZIP    17647 05-05-89  [04] Another game from the author of Tetris
  220.     S/e/m/a/j Communications FileSummary                              Page 5
  221.  
  222.     How do you run FileSummary?
  223.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  224.     Basically,  you  change to  the global RemoteAccess directory containing
  225.     FILES.RA and FSUMM.CFG,  our special control file,  and type or put in a
  226.     batch file the command  to run FSUMM.EXE. Not  all that tricky, eh?! You
  227.     must have no more than  128 characters (including any comments) in  each
  228.     line of FILES.BBS. If you want to use a different config file name, then
  229.     specify it on the command line ie FSUMM E:\BETA\FSMCDROM.CFG..
  230.  
  231.     You also need a header file if you intend on using the FILES.BBS headers
  232.     named with the AreaHeader verb.  You may include the following macros in
  233.     the header file:
  234.  
  235.     %DATE   (24 characters) displays the current date and time in the output
  236.     %DIR    (47 characters) displays the name of the area  (right justified)
  237.     %LDIR   (47 characters) displays the name of the area   (left justified)
  238.     %FNO    (3  characters) displays the number of files in the current area
  239.     %FBYTES (9  characters) displays the number  of  bytes used in the  area
  240.     %DLOADS (4  characters) displays the number  of  downloads  in the  area
  241.  
  242.     Before the header file is put in the FILES.BBS, there is an ID line that
  243.     lets FSUMM know that it has already processed that file. If, in the past
  244.     you have run FSUMM, the old header in the FILES.BBS file should be wiped
  245.     automatically anyway. But be on the safe side and check first though.
  246.  
  247.     When FSUMM is run, a short file containing just a number will be created
  248.     in the directory it is run in (should always be your main RA directory).
  249.     Read the following sentence over to yourself until you understand it: DO
  250.     NOT DELETE THIS FILE. It is a special file used internally by FSUMM, and
  251.     if it is deleted your headers may appear twice or something wierd.  This
  252.     file is called FSUMM.INF. Another file is created if you use the builtin
  253.     files-counter routine, FSUMM.MRK, and markers will be added to your log.
  254.  
  255.     How do I make a FSUMM.CFG file?
  256.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  257.     Good question.  It's an ordinary ASCII file with a few special  commands
  258.     in;  included with FileSummary  is a sample of what you can use and what
  259.     the verbs do. Lines beginning with % or ; are ignored by FSUMM.  You can
  260.     remove the comments from the sample file to speed up processing by quite
  261.     a large amount..
  262.  
  263.     Please look at the sample control file for all the verbs, there are full
  264.     descriptions in it as well.
  265.  
  266.     This  is just the command set available for this version of FileSummary.
  267.     Who knows what will be in the next version! If you have any ideas,  then
  268.     please  contact  James Berry on S/e/m/a/j,  the S/e/m/a/j Communications
  269.     Support Board: 0303 862415, FidoNet 2:440/16.
  270.  
  271.     That's also the number to call (or FidoNet address to send mail to)   if
  272.     you have any bug reports, constructive criticisms, etc.
  273.  
  274.     See SEMAJ.LST for a list of BBS where you may find latest releases.
  275.     S/e/m/a/j Communications FileSummary                              Page 6
  276.  
  277.     An Example Of FILES.BBS Sorting
  278.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  279.     - Before -
  280.     ■──────────────────────────────────────────────────────────────────────┐
  281.     │ * S/e/m/a/j Communications Files - Release Versions                  │
  282.     │                                                                      │
  283.     │ BBS100.ZIP   BBSort - Sorts your FILES.BBS                           │
  284.     │ RAB102.ZIP   RA BitLoc - Unlocks COM-Port for doors                  │
  285.     │ AM200.ZIP    AutoMsg - Sends msgs to newusers, etc                   │
  286.     │ FSM320.ZIP   FSummary - Another FILES.BBS utility                    │
  287.     │                                                                      │
  288.     │ * S/e/m/a/j Communications Files - ßeta Test - Password Protected    │
  289.     │                                                                      │
  290.     │ RCV110.ZIP   new rarcv                                               │
  291.     │ FSM330.ZIP   the best just gets better...                            │
  292.     │ NLL120.ZIP   create text file from nodelist                          │
  293.     └──────────────────────────────────────────────────────────────────────┘
  294.     - After -
  295.     ■──────────────────────────────────────────────────────────────────────┐
  296.     │ * S/e/m/a/j Communications Files - Release Versions                  │
  297.     │                                                                      │
  298.     │ AM200.ZIP    AutoMsg - Sends msgs to newusers, etc                   │
  299.     │ BBS100.ZIP   BBSort - Sorts your FILES.BBS                           │
  300.     │ FSM320.ZIP   FSummary - Another FILES.BBS utility                    │
  301.     │ RAB102.ZIP   RA BitLoc - Unlocks COM-Port for doors                  │
  302.     │                                                                      │
  303.     │ * S/e/m/a/j Communications Files - ßeta Test - Password Protected    │
  304.     │                                                                      │
  305.     │ FSM330.ZIP   the best just gets better...                            │
  306.     │ NLL120.ZIP   create text file from nodelist                          │
  307.     │ RCV110.ZIP   new rarcv                                               │
  308.     └──────────────────────────────────────────────────────────────────────┘
  309.  
  310.     Other Major S/e/m/a/j Products
  311.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  312.     AutoMsg 2.20  -  The Automatic Message Generator - creates  a variety of
  313.     messages  for special occasions,  for example new users and uploads.  It
  314.     can  also generate a daily information message to you, listing new users
  315.     and  so on,  the number of calls you've had,  the amount of  disk  space
  316.     left, etc... And much, much, MUCH more!!!             Release: IMMINENT!
  317.  
  318.     RA  BitLoc 1.10  -  This utility will unlock your COM-port if you use  a
  319.     locked com port to run  doors.  Many doors do not support speeds of more
  320.     than 19200bps but you need to lock  your com-port at 38400bps with quite
  321.     a few modems to get best effects for file transfer. This will unlock the
  322.     speed down to the connect speed (registered users may 'lowlock' down  to
  323.     19200bps for example). Uses DORINFO1.DEF as its interface file.
  324.  
  325.     RA_Receive  -  Goes  through  the message base  looking  for  unreceived
  326.     messages  to  anyone with a certain flag set in USERS.BBS in  the  areas
  327.     defined by you. It then marks them received. This is a great help if you
  328.     have  sysops  calling  your board who have loads  of  echomail  to  wade
  329.     through before getting to local messages and so on.
  330.  
  331.     (c) stuart henderson, 1991.
  332.   ╔══════════════════════════════════════════════════════════════════════════╗
  333.   ║*** A copy of the SOURCE CODE of any S/e/m/a/j utility is available on ***║
  334.   ║*** ── request for the sum of £500 ── subject to authors discretion ── ***║
  335.   ╚══════════════════════════════════════════════════════════════════════════╝
  336.